[MZ] Phileas_EventLabel

**Phileas** · 06.07.2023, 03:59

Название плагина: Phileas_EventLabel

Автор: Phileas

Версия: 1.2.1 для MZ

Дата выхода:
1.0.0 - 05.07.2023
1.1.0 - 07.07.2023
1.1.1 - 07.07.2023
1.2.0 - 18.07.2023
1.2.1 - 16.12.2023

Описание плагина:
Плагин добавляет надписи над событиями карты.

Используйте поле note (примечание). Оно расположено справа от поля "Название" в редакторе события.
Там вы можете ввести один или несколько из следующих тегов:
* <LabelText:Name> - показывает надпись "Имя". Здесь поддерживаются все стандартные символы управления движка.
* <LabelFontSize:26> - устанавливает размер шрифта для конкретной надписи.
* <LabelImage:Actor1> - отображает картинку "Actor1.png" (из игровой папки picture).
* <LabelImagePositionLeft:yes> - если "yes", картинка будет отображена слева от текста надписи.
* <LabelXOffset:0> - устанавливает горизонтальное смещение для конкретной надписи.
* <LabelYOffset:25> - устанавливает вертикальное смещение для конкретной надписи.
* <LabelDistance:50> - расстояние, за пределами которого надпись скрыта.
* <LabelCheckDirection:yes> - если "yes", надпись не отображается, если игрок не смотрит в сторону события.
* <LabelHideInvisible:no> - если "yes", надпись будет скрыта, если событие невидимо.

Необходимо обязательно использовать тег <LabelText> или <LabelImage> (хотя бы один из них, можно оба), если вы хотите отобразить надпись над событием. Остальные теги необязательны. Если вы их не запишете, будут использоваться значения по умолчанию, настраиваемые в параметрах плагина.

Вы можете задать надпись персонажу игрока через параметр или команду плагина. Используйте те же теги, что для событий карты.

Команды плагина:
* Show all labels - отображает все надписи на карте; если надписи невидимых событий скрываются, то вы не увидите их надписи.
* Hide all labels - скрывает все надписи на карте.
* Redraw all labels - перерисовывает содержимое окон с надписями, не удаляя сами окна.
* Set the label text by id - изменяет текст надписи события на произвольный.
* Set the player label text - изменяет текст надписи персонажа игрока на произвольный.
* Show the player label - отображает надпись персонажа игрока; если скрывается надпись невидимого игрока и игрок невидимый, то вы не увидите надпись.
* Hide the player label - скрывает надпись персонажа игрока.

Как это выглядит:

Код:

Спойлер Версия 1.2.1:

Код:

//=============================================================================
// Phileas_EventLabel.js
//=============================================================================
// [Update History]
// 2023.July.05 Ver1.0.0 First Release
// 2023.July.07 Ver1.1.0 Added a player label and hiding invisible event labels
// 2023.July.07 Ver1.1.1 Fix
// 2023.July.18 Ver1.2.0 Added image display.
// 2023.December.16 Ver1.2.1 Fixed checking the player's direction.

/*:
 * @target MZ
 * @plugindesc Labels above map events
 * @author Phileas
 *
 * @param Draw by default
 * @type boolean
 * @default true
 * @desc If true, the labels appear automatically after loading the map.
 *
 * @param Default x offset
 * @type number
 * @default 0
 * @desc Applies if the parameter is not specified via the tag.
 *
 * @param Default y offset
 * @type number
 * @default 25
 * @desc Applies if the parameter is not specified via the tag.
 *
 * @param Default font size
 * @type number
 * @default 26
 * @desc Applies if the parameter is not specified via the tag.
 *
 * @param Default distance
 * @type number
 * @default 500
 * @desc The distance beyond which the label is hidden. Applies if the parameter is not specified via the tag.
 *
 * @param Default check direction
 * @type boolean
 * @default false
 * @desc If true, the label is not shown if the player is not looking towards the event. Applies if the parameter is not specified via the tag.
 *
 * @param Minimum width
 * @type number
 * @default 130
 * @desc Minimum width of the label window. You hardly need to change that.
 *
 * @param Default player label
 * @type string
 * @desc The label that is displayed above the game character, unless another one has been set via the plugin command. Input an empty string so that the label is not displayed.
 *
 * @param Hide the invisible character label
 * @type boolean
 * @default true
 * @desc If the character is invisible, then its label will not be displayed.
 *
 * @param Default picture position is on the left
 * @type boolean
 * @default true
 * @desc If the label has a picture set and the parameter is true, then the picture is displayed to the left of the label text, otherwise - to the right.
 *
 * @command showAllLabels
 * @text Show all labels
 * @desc Displays all labels on the map. If the labels of invisible events are hidden, then you will not see the labels.
 *
 * @command hideAllLabels
 * @text Hide all labels
 * @desc Hides all labels on the map.
 *
 * @command redrawAllLabels
 * @text Redraw all labels
 * @desc Redraws the contents of the label windows without deleting the windows themselves.
 *
 * @command setLabelText
 * @text Set the label text by id
 * @desc Changes the text of the event label to an arbitrary one.
 * @arg eventId
 * @text Event ID
 * @type number
 * @desc Input a event ID (it is a positive number).
 * @default 1
 * @arg text
 * @text Text
 * @type string
 * @desc Input text. If you input an empty line, the label will not be displayed. It can be used to hide a label.
 * @default String
 *
 * @command setPlayerLabelText
 * @text Set the player label text
 * @desc Changes the text of the player character label to an arbitrary one.
 * @arg text
 * @text Text
 * @type string
 * @desc Input text. If you input an empty line, the label will not be displayed. It can be used to hide a label.
 * @default String
 *
 * @command showPlayerLabel
 * @text Show the player label
 * @desc Displays the player label. If the invisible player label is hidden, then you will not see the label.
 *
 * @command hidePlayerLabel
 * @text Hide the player label
 * @desc Hides the player label.
 *
 * 
 * @help
 * Boosty: https://boosty.to/phileas
 *
 * The plugin adds labels above map events.
 *
 * Use the note field. It is located to the right of the name field in the event editor. 
 * There you can enter one or more of the following tags:
 * <LabelText:Name> - shows the label "Name". Standard engine control symbols are supported here.
 * <LabelFontSize:26> - sets the font size for a specific label.
 * <LabelImage:Actor1> - displays the picture "Actor1.png".
 * <LabelImagePositionLeft:yes> - if "yes", the image will be displayed to the left of the label text.
 * <LabelXOffset:0> - sets the horizontal offset for a specific label.
 * <LabelYOffset:25> - sets the vertical offset for a specific label.
 * <LabelDistance:50> - the distance beyond which the label is hidden.
 * <LabelCheckDirection:yes> - if "yes", the label is not shown if the player is not looking towards the event.
 * <LabelHideInvisible:no> - if "yes", the label will be hidden if the event is invisible.
 *
 * It is mandatory to use the <LabelText> or <LabelImage> tag (at least one of them, you can use both) if you want to display the label above the event. The other tags are optional. If you don't write them, the default values that are configured in the plugin parameters will be used.
 *
 * You can assign a label to the player character via the plugin parameter or command. Use the same tags as for map events.
 * 
 * Plugin Commands:
 * 0) Show all labels - displays all labels on the map; if the labels of invisible events are hidden, then you will not see their labels.
 * 1) Hide all labels - hides all labels on the map.
 * 2) Redraw all labels - redraws the contents of the label windows without deleting the windows themselves.
 * 3) Set the label text by id - changes the text of the event label to an arbitrary one.
 * 4) Set the player label text - changes the text of the player character label to an arbitrary one.
 * 5) Show the player label - displays the player label; if the invisible player label is hidden and the player is invisible, then you will not see the label.
 * 6) Hide the player label - hides the player label.
 *
 * [License]
 * This plugin is released under MIT license.
 * http://opensource.org/licenses/mit-license.php
 */

(function() {

//--------MY CODE:  
    PluginManager.registerCommand("Phileas_EventLabel", "showAllLabels", showPhileasEventLabels);
    PluginManager.registerCommand("Phileas_EventLabel", "hideAllLabels", hidePhileasEventLabels);
    PluginManager.registerCommand("Phileas_EventLabel", "redrawAllLabels", redrawPhileasEventLabels);
    PluginManager.registerCommand("Phileas_EventLabel", "setLabelText", setPhileasEventLabelText);
    PluginManager.registerCommand("Phileas_EventLabel", "setPlayerLabelText", setPhileasPlayerLabelText);
    PluginManager.registerCommand("Phileas_EventLabel", "showPlayerLabel", showPhileasPlayerLabel);
    PluginManager.registerCommand("Phileas_EventLabel", "hidePlayerLabel", hidePhileasPlayerLabel);

    var parameters = PluginManager.parameters("Phileas_EventLabel");
    
    var PhileasEventLabelSettings = PhileasEventLabelSettings || {};
    PhileasEventLabelSettings.drawByDefault = (parameters["Draw by default"] || "true") == "true";
    PhileasEventLabelSettings.defaultXOffset = parameters["Default x offset"] || 0;
    PhileasEventLabelSettings.defaultYOffset = parameters["Default y offset"] || 25;
    PhileasEventLabelSettings.defaultFontSize = parameters["Default font size"] || 26;
    PhileasEventLabelSettings.defaultDistance = parameters["Default distance"] || 500;
    PhileasEventLabelSettings.defaultCheckDirection = (parameters["Default check direction"] || "false") == "true";
    PhileasEventLabelSettings.minWidth = parameters["Minimum width"] || 130;
    PhileasEventLabelSettings.defaultPlayerLabel = parameters["Default player label"] || "";
    PhileasEventLabelSettings.hideInvisibleCharacterLabel = (parameters["Hide the invisible character label"] || "true") == "true";
    PhileasEventLabelSettings.defaultPicturePositionIsLeft = (parameters["Default picture position is on the left"] || "true") == "true";
    PhileasEventLabelSettings.tags = ["LabelText", "LabelFontSize", "LabelXOffset", "LabelYOffset", "LabelDistance", "LabelCheckDirection", "LabelHideInvisible", "LabelImage", "LabelImagePositionLeft"];
    
    var playerLabelWindow = undefined;


    function PhileasEventLabelData() {
        this.LabelText = "";
        this.LabelXOffset = PhileasEventLabelSettings.defaultXOffset;
        this.LabelYOffset = PhileasEventLabelSettings.defaultYOffset;
        this.LabelFontSize = PhileasEventLabelSettings.defaultFontSize;
        this.LabelDistance = PhileasEventLabelSettings.defaultDistance;
        this.LabelCheckDirection = PhileasEventLabelSettings.defaultCheckDirection;
        this.LabelHideInvisible = PhileasEventLabelSettings.hideInvisibleCharacterLabel;
        this.LabelImage = "";
        this.LabelImagePositionLeft = PhileasEventLabelSettings.defaultPicturePositionIsLeft;
    }
    PhileasEventLabelData.prototype.constructor = PhileasEventLabelData;


    function Window_PhileasEventLabel() {
        this.initialize(...arguments);
    }
    
    Window_PhileasEventLabel.prototype = Object.create(Window_Base.prototype);
    Window_PhileasEventLabel.prototype.constructor = Window_PhileasEventLabel;

    Window_PhileasEventLabel.prototype.initialize = function(eventObject, isVisible, isEventVisible) {
        this.eventObject = eventObject;
        this.isVisible = isVisible;
        this.isEventVisible = isEventVisible;
        this.phileasEventLabelData = new PhileasEventLabelData();
        let width = PhileasEventLabelSettings.minWidth;
        Window_Base.prototype.initialize.call(this, new Rectangle(0, 0, width, this.fittingHeight(1) + 10));
        this.opacity = this.contentsOpacity = 0;
        this.visible = false;
        this.setPhileasLabelData(eventObject.note);
        this.drawPhileasLabel();
        SceneManager._scene._spriteset.addChild(this);
    };
    
    Window_PhileasEventLabel.prototype.lineHeight = function() {
        return this.phileasEventLabelData.LabelFontSize;
    };
    
    function getMeta(data) {
        const regExp = /<([^<>:]+)(:?)([^>]*)>/g;
        let meta = {};
        for (;;) {
            const match = regExp.exec(data);
            if (match) {
                if (match[2] === ":") {
                    meta[match[1]] = match[3];
                } else {
                    meta[match[1]] = true;
                }
            } else {
                break;
            }
        }
        
        return meta;
    };
    
    Window_PhileasEventLabel.prototype.setPhileasLabelData = function(data) {
        let meta = getMeta(data);
        if (meta == undefined) {
            return;
        }
        
        for (let i in PhileasEventLabelSettings.tags) {
            let tag = PhileasEventLabelSettings.tags[i];
            if (meta[tag] != undefined) {
                this.phileasEventLabelData[tag] = meta[tag];
            }
        }
        
        this.phileasEventLabelData.LabelFontSize = Number(this.phileasEventLabelData.LabelFontSize);
        this.phileasEventLabelData.LabelXOffset = Number(this.phileasEventLabelData.LabelXOffset);
        this.phileasEventLabelData.LabelYOffset = Number(this.phileasEventLabelData.LabelYOffset);
        this.phileasEventLabelData.LabelDistance = Number(this.phileasEventLabelData.LabelDistance);
        this.phileasEventLabelData.LabelCheckDirection = this.phileasEventLabelData.LabelCheckDirection == true || this.phileasEventLabelData.LabelCheckDirection == "yes";
        this.phileasEventLabelData.LabelHideInvisible = this.phileasEventLabelData.LabelHideInvisible == true || this.phileasEventLabelData.LabelHideInvisible == "yes";
        this.phileasEventLabelData.LabelImagePositionLeft = this.phileasEventLabelData.LabelImagePositionLeft == true || this.phileasEventLabelData.LabelImagePositionLeft == "yes";
    }
    
    function isRightDirection(pX, pY, eX, eY) {
        switch ($gamePlayer.direction()) {
            case 1:
                return pX > eX && pY < eY;
            case 2:
                return pY < eY;
            case 3:
                return pX < eX && pY < eY;
            case 4:
                return pX > eX;
            case 6:
                return pX < eX;
            case 7:
                return pX > eX && pY > eY;
            case 8:
                return pY > eY;
            case 9:
                return pX < eX && pY > eY;
        }
        
        return false;
    }
    
    Window_PhileasEventLabel.prototype.isPhileasEventLabelVisible = function() {
        if (this.phileasEventLabelData.LabelText == "" || !this.isVisible 
            || this.phileasEventLabelData.LabelHideInvisible && !this.isEventVisible) {
            return false;
        }
        
        let pX = $gamePlayer.x;
        let pY = $gamePlayer.y;
        if (this.phileasEventLabelData.LabelDistance < Math.abs(pX - this.eventObject.x) 
            || this.phileasEventLabelData.LabelDistance < Math.abs(pY - this.eventObject.y)
            || this.phileasEventLabelData.LabelCheckDirection && !isRightDirection(pX, pY, this.eventObject.x, this.eventObject.y)
            || SceneManager._scene._encounterEffectDuration > 0)
        {
            return false;
        }
          
        return true;
    };
    
    Window_PhileasEventLabel.prototype.show = function() {
        if (this.contentsOpacity >= 255) { 
            return;
        }
        
        this.contentsOpacity += 20;
        this.visible = true;
    };

    Window_PhileasEventLabel.prototype.hide = function() {
        if (this.contentsOpacity <= 0) {
          if (this.visible) { 
              this.visible = false;
          }
          return;
        }
        this.contentsOpacity -= 20;
    };
    
    Window_PhileasEventLabel.prototype.tryShow = function() {
        if (this.isPhileasEventLabelVisible()) {
            this.show();
            return;
        }
        
        this.hide();
    };
    
    Window_PhileasEventLabel.prototype.resetFontSettings = function() {
        Window_Base.prototype.resetFontSettings.call(this);
        this.contents.fontSize = this.phileasEventLabelData.LabelFontSize;
    };
    
    Window_PhileasEventLabel.prototype.drawPhileasLabelPicture = function(x, offset = 0) {
        const bitmap = this.phileasLabelBitmap;
        if (offset == 0) {
            this.contents.blt(bitmap, 0, 0, bitmap.width, bitmap.height, x - bitmap.width, 0);
        }
        else {
            this.contents.blt(bitmap, 0, 0, bitmap.width, bitmap.height, x + offset, 0);
        }
    }
    
    Window_PhileasEventLabel.prototype.drawPhileasLabel2 = function() {
        this.contents.clear();
        let textWidth = this.textSizeEx(this.phileasEventLabelData.LabelText).width;
        if (textWidth > 0) {
            textWidth += this.itemPadding() * 2;
        }
        
        this.width = Math.max(textWidth, PhileasEventLabelSettings.minWidth) + this.imageWidth + this.padding * 2;
        if (this.imageWidth > 0) {
            this.width += textWidth * 2;
        }
        
        this.height = this.fittingHeight(1) + 10 + this.imageHeight;
        this.createContents();
        let wx = (this.contents.width - textWidth) / 2 + this.itemPadding();
        if (this.phileasLabelBitmap != undefined) {
            if (this.phileasEventLabelData.LabelImagePositionLeft) {
                this.drawPhileasLabelPicture(wx);
            }
            else {
                this.drawPhileasLabelPicture(wx, textWidth);
            }
        }
        
        if (this.phileasEventLabelData.LabelText == "") {
            this.phileasEventLabelData.LabelText = " ";
        }
        
        this.drawTextEx(this.phileasEventLabelData.LabelText, wx, 0, textWidth);
        this.visible = true;
        if (this.isPhileasEventLabelVisible()) {
            this.contentsOpacity = 255;
        }
    }
    
    Window_PhileasEventLabel.prototype.setPhileasLabelPictureSizes = function() {
        this.phileasLabelBitmap = undefined;
        if (this.phileasEventLabelData.LabelImage == "") {
            this.imageWidth = 0;
            this.imageHeight = 0;
            this.drawPhileasLabel2();
            return;
        }
        
        this.phileasLabelBitmap = ImageManager.loadPicture(this.phileasEventLabelData.LabelImage);
        this.phileasLabelBitmap.addLoadListener(() => {
            const bt = this.phileasLabelBitmap.baseTexture;
            this.imageWidth = bt.width + this.itemPadding() * 6;
            this.imageHeight = bt.height;
            this.drawPhileasLabel2();
        });
    }
    
    Window_PhileasEventLabel.prototype.drawPhileasLabel = function() {
        this.setPhileasLabelPictureSizes();
    }

    Scene_Map.prototype.drawPhileasEventLabels = function() {
        if (!(SceneManager._scene instanceof Scene_Map)) {
            return;
        }

        //let events = $gameMap.events();
        let events = SceneManager._scene._spriteset._characterSprites;
        SceneManager._scene.phileasLabelWindows = {};
        for (var i = 0; i < events.length; ++i) {
            if (events[i]._character instanceof Game_Player) {
                $gamePlayer.note = PhileasEventLabelSettings.defaultPlayerLabel;
                playerLabelWindow = new Window_PhileasEventLabel($gamePlayer, true, events[i].visible);
                events[i].phileasEventLabelWindow = playerLabelWindow;
                continue;
            }
            
            if (!(events[i]._character instanceof Game_Event)) {
                continue;
            }

            let e = events[i]._character.event();
            if (e.meta.LabelText != undefined || e.meta.LabelImage != undefined) {
                let label = new Window_PhileasEventLabel(e, PhileasEventLabelSettings.drawByDefault, events[i].visible);
                SceneManager._scene.phileasLabelWindows[e.id] = label;
                events[i].phileasEventLabelWindow = label;
            }
        }
    };
    
    Sprite_Character.prototype.setPhileasEventLabelPosition = function() {
        let scale = SceneManager._scene._spriteset.scale;
        let scaleX = 1 / scale.x;
        let scaleY = 1 / scale.y;
        let width = this.phileasEventLabelWindow.width * scaleX;
        this.phileasEventLabelWindow.x = this.x - width / 2 + this.phileasEventLabelWindow.phileasEventLabelData.LabelXOffset;
        let height = this.phileasEventLabelWindow.height * scaleY;
        let offset = this.phileasEventLabelWindow.phileasEventLabelData.LabelYOffset * scaleY;
        this.phileasEventLabelWindow.y = this.y - this.height - height + offset;
    };
    
    function iteratePhileasEventLabels(func) {
        let scene = SceneManager._scene;
        if (!(scene instanceof Scene_Map)) {
            return;
        }
        
        for (const [key, label] of Object.entries(scene.phileasLabelWindows)) {
            func(label);
        }
    }
    
    function showPhileasEventLabel(label) {
        label.isVisible = true;
    }
    
    function showPhileasEventLabels() {
        iteratePhileasEventLabels(showPhileasEventLabel);
    };
    
    function hidePhileasEventLabel(label) {
        label.isVisible = false;
    }
    
    function hidePhileasEventLabels() {
        iteratePhileasEventLabels(hidePhileasEventLabel);
    };
    
    function redrawPhileasEventLabel(label) {
        label.drawPhileasLabel();
    }
    
    function redrawPhileasEventLabels() {
        iteratePhileasEventLabels(redrawPhileasEventLabel);
    };
    
    function setPhileasEventLabelText(params) {
        let scene = SceneManager._scene;
        let eventId = Number(params["eventId"]);
        if (!(scene instanceof Scene_Map) || eventId < 1 || eventId > $gameMap.events().length) {
            return;
        }
        
        let text = params["text"];
        if (text == undefined) {
            text = "";
        }
        
        let label = undefined;
        if (eventId in scene.phileasLabelWindows) {
            label = scene.phileasLabelWindows[eventId];
        }
        else {
            label = new Window_PhileasEventLabel($gameMap.event(eventId).event(), PhileasEventLabelSettings.drawByDefault);
            scene.phileasLabelWindows[eventId] = label;
            let sprites = scene._spriteset._characterSprites;
            for (let i = 0; i < sprites.length; ++i) {
                if (sprites[i]._character instanceof Game_Event && sprites[i]._character.event().id == eventId) {
                    sprites[i].phileasEventLabelWindow = label;
                    break;
                }
            }
            
        }
        
        label.setPhileasLabelData(text);
        label.drawPhileasLabel();
    }
    
    function setPhileasPlayerLabelText(params) {
        let text = params["text"];
        if (text == undefined) {
            text = "";
        }
        
        playerLabelWindow.setPhileasLabelData(text);
        playerLabelWindow.drawPhileasLabel();
    }

    function showPhileasPlayerLabel() {
        showPhileasEventLabel(playerLabelWindow);
    }
    
    function hidePhileasPlayerLabel() {
        hidePhileasEventLabel(playerLabelWindow);
    }

//--------CHANGED CORE:

    const Origin_onMapLoaded = Scene_Map.prototype.onMapLoaded;
    Scene_Map.prototype.onMapLoaded = function() {
        Origin_onMapLoaded.call(this);
        this.drawPhileasEventLabels();
    };
    
    const Origin_eventUpdate = Sprite_Character.prototype.update;
    Sprite_Character.prototype.update = function() {
        Origin_eventUpdate.call(this);
        if (this.phileasEventLabelWindow != undefined) {
            this.phileasEventLabelWindow.isEventVisible = this.visible;
            this.setPhileasEventLabelPosition();
            this.phileasEventLabelWindow.tryShow();
        }
    };
}());

Или можно скачать файл тут.

Лицензия
MIT, вся ответственность на пользователе.

Совместимость:
Если будут проблемы - пишите мне.

**Phileas** · 07.07.2023, 22:57

Обновление 1.1.0!

* Вы можете задать надпись персонажу игрока через параметр или команду плагина.
* С помощью параметра плагина или тега можно скрывать надписи невидимых событий (включая персонажа игрока).
* 3 новых команды плагина, которые позволяют задать надпись игроку, а также принудительно показать или скрыть надпись.

Все подробности в первом сообщении темы.

Пишите мне, если обнаружите какие-то проблемы или у вас возникнут вопросы. Я открыт к предложениям по новым фичам.

UPD: хотфикс 1.1.1, исправил баги, связанные с boolean-параметрами и командами плагина.

Boosty

**Phileas** · 18.07.2023, 23:04

Обновление до версии 1.2.0!

Теперь в надписях можно использовать картинки (из игровой папки picture).
Для настройки картинок добавлены 2 тега: LabelImage и LabelImagePositionLeft.
Обязательно для показа надписи нужно использовать либо LabelText, либо LabelImage (можно оба, но необязательно).
Значение LabelImagePositionLeft по умолчанию задаётся в параметрах плагина.

Подробнее в первом сообщении темы.

**Phileas** · 16.12.2023, 14:34

Версия 1.2.1

Исправлена проверка направления игрока.

**Phileas** · 20.04.2024, 12:23

1.2.2

Исправил баг в команде плагина "Set the label text by id"

**Phileas** · 23.04.2024, 17:50

1.2.4

Исправил проблему, из-за которой при некоторых значениях размера шрифта текст обрезался. Также теперь можно гибко настраивать междустрочный интервал (опция влияет на высоту строки).